home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Reference Guide / C-C++ Interactive Reference Guide.iso / c_ref / csource3 / 144_01 / page.hlp < prev    next >
Text File  |  1985-08-21  |  3KB  |  63 lines
  1. **********************************************************************
  2. *                              PAGE                                  *
  3. **********************************************************************
  4. *                  COPYRIGHT 1983 EUGENE H. MALLORY                  *
  5. **********************************************************************
  6. PROGRAM:
  7.     PAGE - Formats text into pages with file headers and page
  8.      numbers.
  9. USAGE:
  10.     PAGE [<fid] afn ... [-Ln] [-W] [-N] [-P] [-H] [>fid]
  11.     
  12. FUNCTION:
  13.     This can act either as a filter or a source.  If the command line 
  14.     contains filenames, these files are read, formatted, and titled. 
  15.     Afn's may be used for these file names. Each file will 
  16.     start on a separate page, and each page will be filled out.
  17.     
  18.     The standard page length of 66 lines is assumed unless otherwise
  19.     specified by the "-Ln" option.  Six lines of each page are used 
  20.     as white space, and header.  The -Ln specification should give 
  21.     the full page size (e.g. 66).
  22.     
  23.     The -W specification will cause the program to wait at the
  24.     beginning of each page.  Hitting a CR will cause the next page
  25.     to be output.  This is for "paging" through output on a screen, 
  26.     or to use with a cut paper printer.
  27.     
  28.     The -P (plain) specification eliminates the page numbering 
  29.     and headers, and just puts 3 blank lines at the beginning and end 
  30.     of each page.
  31.     
  32.     The -N specification adds line numbers to each files as it is
  33.     copied.  Each file is line numbered separately.
  34.     
  35.     The -H specification lists the available options.
  36.     
  37.     If there is directed input, either from a pipe or from a file, 
  38.     this input is also formatted at the end of any of the files 
  39.     obtained from the command line specifications.  Under no 
  40.     circumstances will this program accept input from the normal 
  41.     keyboard input path.  This allows it to be used as a simple 
  42.     source when no directed input is used.
  43.     
  44. EXAMPLE:
  45.     PAGE *.HLP -L22 -W
  46.     PAGE F1 F2 F3 >FALL
  47.     PAGE <FILE >LST:    
  48.  
  49.         Command Line                       
  50. ___________________________________  
  51.                                   |  
  52.                                   |  
  53.                                   |  AMBIGUOUS FILE NAME LIST
  54.                                   |          & OPTIONS
  55.                                   |                  
  56.                     ______________V______________    
  57.  Standard Input     |                           |   Standard Output
  58.      TEXT           |                           |    PAGED TEXT
  59. ------------------->|           PAGE            |----------------------->
  60.                     |                           |
  61.                     |                           |
  62.                     |___________________________|
  63.